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ABSTRACT and CONTENTS 

This document specifies the format of program images (files 
containing complete programs) in the Model 1 software system. 
Such files may be run as subprocesses, loaded into SPL, or 
written on tape for use in system startup. The ATTACH UCALL, 
for making a subprocess out of a program image, is described 
in general terms . 
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A program image consists of a collection of data pages 
which form a program, a map describing how to arrange them 
in the appropriate ring of the Ml address space, and enough 
additional information to: 

(1) turn them into a subprocess; 

(2) write them out as part of a system initialization 
tape ; 

(3) load them into SPL, including the source program 
they were compiled from. 

The information required for (1) and (2) is actually part 
of the data; for (3), SPL appends information of its own 
beyond the actual data pages . The overall layout of program 
images is shown in figure 1; the three uses of such files is 
now discussed in detail . 
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The first forty- six words (see Figure 2) of a program 
image contain the information necessary to set up a complete 
sub-process entry. The format code is included to allow 
us to revise the header while maintaining the use of old 
files . If CUNF is non-zero, the MIB owner number will be 
copied to PAK1 of the sub-process . EP and EG are copied 
to the SPT entry. EP should point to the sub-process entry 
point array descriptor. The Utility Name contains either 
the Basic File System Name for the utility under which 
this file runs or else the main: name should be blank to 
mean use the current utility. 

The map has 64 12-bit bytes . Each byte is interpreted as 
follows: 

Code (CD) Action 

Put in this map byte. 

1 Put the file page (specified by the index) 
into PMT read-only. 

2 Create a PMT page . 

3 Copy the file page to a new PMT page . 

In cases 1 to 3 the PMT byte number is placed in the 
corresponding map byte . 



bcc 



p/c-n.r 

PIF/S- 21 



page 



Specification for ATTACH 

Declaration: 

ATTACH (SPTX, ARRAY FN) , FRETURN; 

Success Return: 
RETURN SPTX; 

Failure Returns: 

If the file cannot be opened, or if the sub-process can- 
not be created, or if PMT fills up. 

Action: 

The file FN is opened and a sub-process is created using SPTX 
as a parameter. Page $ of the file is examined and 
the SPT entry is set according to the header. Then using the 
file map, the pages of the file are placed in PMT or copied 
to a new page and the new sub-process' map is cohstrtiGted . 
Finally the file is closed. If an error arises during the exe- 
cution of ATTACH, the sub-process is destroyed, all memory is 
released, and the file closed. All PMT bytes created by 
ATTACH will be controlled by the new sub-process. Initially 
ATTACH will be part of the standard utility. 
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Real Name Table 

The purpose of the real name table is for "bare machine" 
simulation. Thus it only concerns operating system pro- 
grammers. (Details forthcoming in the SP L debugging 
manual.) 

The table pointed to by the second word of the file is 
shown in Figure 3 . The address given in the header is the 
virtual address of the table and thus must be mapped. This 
table contains the real name of each page, and for 'bootstrap 
programs will also contain its initial core address. A 
program will be written to generate a system image tape from 
these files. This table will also be used to simulate the 
"bare machine". 
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Outline of Program Image 



Figure 1 
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Format Code 



Number of Data Pages 



Address of Real Name Table * 
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Utility Name 



> main: name 



Copy User Number (CUNF) 



Entry Point (EP) 



Entry G-Register (EG) 



* See Figure 3 . 

Data Used by ATTACH and Tape Writer 
Figure 2 
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First Real 
Name 



Last Real 
Name 



a)' Real Name Table 



-2- 



One per program 
data page 



T 



Unique Name (2 words) 



Disk/Drum Address 



Core Page Number 



b) Data in arbitrary table entry 



Format of Real Name Table 
Figure 3 



